/*  GStruct: data structure helpers for Java
 *  Copyright (C) 2011 Giulio Franco
 *
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package gstruct.extensions;

/**
 * A mapper is a function that associates objects of type Src
 * to objects of type Dest, in a similar way to what
 * {@link java.util.Map Map}s do.
 * @author Giulio Franco <giulio_franco@msn.com>
 *
 * @param <Src>		Source type
 * @param <Dest>	Result type
 */
public interface Mapper<Src,Dest> {
	
	/**
	 * Get a mapping for x
	 * @param x		Source object
	 * @return	Result object.
	 * 			If the same object x is passed twice,
	 * 			the method should return the same object,
	 * 			or two equivalent objects.
	 */
	Dest map(Src x);
}
